home *** CD-ROM | disk | FTP | other *** search
/ SGI Enlighten DSM 1.1 / SGI EnlightenDSM 1.1.iso / sco5x / events / help / EventsCli.man < prev    next >
Text File  |  1998-06-30  |  3KB  |  134 lines
  1.  
  2.  
  3.  
  4. EventsCli(8N)     Misc. Reference Manual Pages      EventsCli(8N)
  5.  
  6.      Copyright (c) 1990-1998 Enlighten Software Solutions, Inc.
  7.  
  8.  
  9.      EventsCli - Command Line Interface  for  sending  alarms  to
  10.      Pep, SNMP, etc
  11.  
  12. SYNOPSIS
  13.      EventsCli -n name -v measured_value -u units -s severity  -t
  14.      trap_num -T threshold
  15.  
  16.  
  17. DESCRIPTION
  18.      EventsCli is a user interface to the Events alarm  dispatch-
  19.      ing  facilities.   It can be used to send SNMP traps, notify
  20.      Pep, and log an event.  These events can  be  from  external
  21.      processes that call EventsCli each time a condition warrents
  22.      reporting.
  23.  
  24.      The EventsCli is intended to be an  interface  between  your
  25.      existing system monitoring programs and scripts.  These pro-
  26.      grams and scripts can call EventsCli and then rely upon  the
  27.      SNMP traps, Events data logging, and Pep to take the correc-
  28.      tive action you desire.
  29.  
  30.  
  31. OPTIONS
  32.           -u units
  33.                The units value specifys the unit of  measure  for
  34.                the value measured
  35.           -v measured_value
  36.                The value being reported. This  can  be  any  data
  37.                type including a short string.
  38.           -n name
  39.                A brief name, which must be quoted if it  contains
  40.                white  space,  could  be  a  test  name,  or other
  41.                descriptive text.
  42.           -s severity
  43.                Where severity is a number between a low of 1  and
  44.                a high of 5.
  45.           -t trap_num
  46.                Events  has  twelve  general  purpose  TRAPs   for
  47.                EventsCli.   These  are  numbered from 500 to 511.
  48.                The trap_num you choose can be arbitrary but  must
  49.                be within the range indicated.
  50.            -T threshold
  51.                The name of the threshold  exceeded.   This  is  a
  52.                very  short description of what happened i.e. "low
  53.                alarm threshold".  In real life, any brief text is
  54.                acceptable.
  55.  
  56. EXAMPLE
  57.      EventsCli -n DatabaseA -T "high tps" -u "tps" -v 12345 -s  5
  58.      -t 501
  59.  
  60.      This might mean:  (-c) DatabaseA is doing  (-v)  12345  (-u)
  61.  
  62.  
  63.  
  64. SunOS 5.4                 Last change:                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. EventsCli(8N)     Misc. Reference Manual Pages      EventsCli(8N)
  72.  
  73.  
  74.  
  75.      tps and has exceeded the (-T) high tps threshold.  The event
  76.      will be reported with the highest severity level (-s) 5  and
  77.      will be sent using trap number (-t) 501
  78.  
  79. RESTRICTIONS
  80.      EventsCli must be invoked on a  machine  that  has  AgentMon
  81.      running.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. SunOS 5.4                 Last change:                          2
  131.  
  132.  
  133.  
  134.